home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 680 / aud_cd15 / readme15.plz < prev   
Encoding:
Text File  |  1993-02-24  |  12.2 KB  |  344 lines
  1.   AUDIO COMPACT DISC PLAYER FOR THE ATARI ST/TT SYSTEMS 
  2.                   Version 1.5. February 1993
  3.  
  4.  
  5. WHAT IS NEW??
  6.  
  7. ********************************************************************
  8. What have we added you may ask, Well, finally in version 1.5, you may
  9. choose what track you would like to play. Well, what else you may ask
  10. again? This feature will work with any drive there exist (as long as
  11. they are SCSI), even if other features may not work. Yes, it will
  12. work with MultiTos.
  13.  
  14. ********************************************************************
  15. New stuff in version 1.4 of audio compact disc player, {NEVER
  16. OFFICIALLY RELEASED}
  17.  
  18. 1. There now is an online SCSI command button, that is you can send
  19. any scsi command to the CD ROM right from the desktop. NOTE that it
  20. will accept HEX commands in contrast to the external DATA file that
  21. accepts DEC commands. This function is implemented in the TRACK
  22. button.
  23.  
  24. ********************************************************************
  25. Well folks, this is version 1.3 of the audio compact disk player for
  26. the ATARI ST/TT systems. This is a major upgrade, so stay tuned:
  27.  
  28. 1- It is now a desk accessory, so you can load at boot up time or
  29. load it after boot up using CHAMELEON (Works beautifully) and play
  30. your favourite CD while working with your program. Previouse versions
  31. also supported background playing, but you needed to load the
  32. AUDIO_CD.PRG in order to access your CD ROM and then quit it and go
  33. back to your application; well this is not the case anymore once it
  34. is a D/A.
  35.  
  36. 2- You can now save your configuration (AUDIO_CD.INF) which loads at
  37. boot up time, so once your system is set up for a particular player,
  38. ID and DATA file (your Drives' commands if not supported by AUDIO_CD)
  39. you won't need to answer all those dialog boxes, you can jump
  40. right into playing your CD.
  41.  
  42. 3-An enhancement has been made in loading the data file. Before, you
  43. were restricted to enter commands up to 99 (DEC), so if your command
  44. happened to be greater than 99, then ... . Now, you can enter any
  45. number (up to 32476?), but make sure it is in DEC format, not HEX.
  46.  
  47. 4- It is now compatible with all ST/TT resolutions, (v. 1.2 was only
  48. medium and high on ST/TT), but now I was able to fit all the buttons
  49. and keys to be used on low resolution on ST/TT.
  50.  
  51. 5- Window handling/redraws have become faster, however, it is
  52. recommanded when using the accessory, you would have the least number
  53. of open windows. (the more windows you have open, the more your
  54. system has to put time to redraw them, depending on your system, you
  55. may observe a little bit of slow down in redraws. This effect
  56. vanishes if you use QUICKST/TT 3.0 or Warp 9.
  57.  
  58. 6- Disk accessing is now handled more carefully, so it would inform
  59. you of any possible disk errors. (however, it will not alert you if
  60. you have the wrong DATA (i.e. SCSIII.DAT) or INFO (i.e.,
  61. AUDIO_CD.INF) file, I would guess your system would just crash!!)
  62.  
  63. 7- Many many more internal changes to speed up the processing time.
  64.  
  65. *********************************************************************   
  66.     Version 1.2 of the previously uploaded audio CD player.
  67. This version has the following changes/enhancements:
  68.  
  69. 1- If you happen to have the SCSI commands that your CD ROMS wants
  70. and don't want to wait for me to make an upgrade, you can easily
  71. implement yourself using a text editor and a few rules by a data file
  72. (*.DA). (look at the end of this file and the example file in this
  73. archive.)
  74.  
  75. 2- Due to suggestion of a User, I changed the SCSI ID selection from
  76. 0-15 to 0-7 selectable for ACSI and SCSI ports on the ST/TT.
  77.  
  78. 3- Faster routines!
  79.  
  80. **********************************************************************
  81.  
  82.     Version 1.1 of the previously uploaded audio CD player.
  83. This version is no longer using MENUs, but it has a CD player like
  84. control pannel (very nice) with buttons replacing menus as the
  85. standard user interface. It has fixed many bugs in the previous
  86. version in accessing data files. It should work just fine. Also you
  87. may change your CD ROM drive type and SCSI ID right on the user
  88. interface thus providing a variety of features to be supported:
  89.  
  90. i.e, having multiple drives/ID playing at the same time.
  91.  
  92.    
  93.  
  94.  
  95.  
  96. THE FOLLOWING MUST BE PRESENT IN THIS ARCHIVE: (AND KEEP THEM ALL IN
  97. THE SAME DIRECTORY)
  98.  
  99. AUD_CD15.ACC   
  100. AUD_CDHI.RSC   (Please don't change this file)
  101. AUD_CDLO.RSC   (Please don't change this file)
  102. README.PLZ (THIS FILE)   (Please don't change this file)
  103.  
  104. Fill free to upload this program (unregistered only) to any
  105. BBS/NETWORK as long as it contains this file (README.PLZ).
  106.  
  107.  
  108. DISCLAIMER: I am not responsible for any damage caused by this
  109. program to your systems or devices attached to it. You may use this
  110. program at your own risk. I will not gaurantee that it would work on
  111. your system, nevertheless, it works on my system (ATARI TT030).
  112.  
  113.  
  114. This program is shareware. If you happen to like it and use it, you
  115. are required to pay the shareware fee of only $ 12.00. It is not
  116. much, but it surely helps a strugling student survive through the
  117. university world. Also as a registered owner, you are advised of any
  118. upgrades and also receive the full version.
  119.  
  120. The full version has the following features that are not present in
  121. the demo version:
  122.  
  123.  
  124. 1- You will be able to switch back and forth between songs {the
  125. arrows that you actually see in the track dialog box are for this
  126. purpose, but I have not completed the code yet, so stay tuned, and
  127. don't forget your contribution!!! }
  128.  
  129. NOTE: THIS VERSION WILL STOP RUNNING AFTER YOU OPEN IT 3 TIMES.
  130.  
  131.  
  132.  
  133. In order to receive the registered version, send $12.00 (US) to:
  134.  
  135. NIMA MONTASER
  136. 204-35 HOLLAND AVE.
  137. OTTAWA, ONT.  K1Y 4S2
  138.       CANADA
  139.  
  140.  
  141.  
  142. SYSTEM REQUIREMENTS:
  143.  
  144.    The newly implented feature, TRACK option should work with all CD
  145. players, but some other existing features may not work or may require
  146. external data file. It is your job to inform me of that.
  147.  
  148.    This program should work on any ST/TT with a colour or monochrome
  149. monitor in every possible ST/TT resolutions.
  150.    You also need a CD ROM Drive (no kidding!!) I have tested it on my
  151. own CD ROM (SONY CDU541). However this program has the code to play
  152. all types of NEC CD ROM drives as well. (it may work on other brands
  153. as well).
  154.    It should work with the CD ROM attached to ACSI/SCSI port of the
  155. ST/TT. I have not tested in on the ACSI port of an ST, so I rely on
  156. you to give me feed backs!!
  157.  
  158.  
  159.  
  160. QUICK INSTALLATION:
  161.  
  162. It is very easy, just place AUD_CD15.ACC in the root directory of
  163. your boot disk (with AUDIO_CD.INF, if you happen to have saved one)
  164. and restart your system. You will notice there will be slot in the
  165. DESK menu taken by 'AUDIO CD PLAYER'. Or you may load it with
  166. CHAMELEON or MULTIDESK (not tested). Just make sure you have the
  167. following in the same directory,{AUD_CDHI.RSC for ST/TT high and TT
  168. med. or AUD_CDLO.RSC for ST med&low resolutions}. If you don't have
  169. a AUDIO_CD.INF file, you will be asked to choose the ID and drive
  170. parameters, and then you can save it using the 'SAVE CONFIG.' button
  171. on the interface. If you happen to have neither one of the drives
  172. indicated, choose any of them and play around to see if any of the
  173. functions work. (if you happen to have the commands for your CD ROM,
  174. just follow the rules at the end of this file and make your own data
  175. file) In any case, please send me a note stating your test results.
  176.  
  177. TO CHOOSE YOUR ID: 
  178.  
  179. For ACSI PORT (TT/ST), use 0-7. (choose ACSI botton)
  180. For SCSI PORT (TT), use 0-7 (choose SCSI botton)
  181.  
  182. Make sure you do this. Otherwise it will not work or damage the
  183. device attached to it. The Default value is 3 /SCSI.
  184.  
  185. To quit, click on the 'quit' botton or press 'RETURN'.
  186.  
  187. To save the configuration, click on 'SAVE CONFIG' on the user
  188. interface.
  189.  
  190.  
  191.  
  192. DESCRIPTION OF BUTTONS:
  193.  
  194. You many click on the following bottons:
  195.  
  196. PLAY: IT WILL START TO PLAY THE CD.
  197.  
  198. PAUSE: IT WILL PAUSE THE AUDIO PLAYING. TO RESUME, CLICK ON PLAY.
  199.  
  200. STOP: IT WILL STOP PLAYING AND UPON RESUMING, IT WILL START FROM THE
  201. BEGINING OF THE CD.
  202.  
  203. EJECT: IT WILL EJECT THE CD FROM THE PLAYER (IF YOUR PLAYER IS
  204. CAPABLE OF DOING SO.
  205.  
  206. TRACK : It will display you with number of tracks available, and
  207. would ask you to enter the track you would like it to play, or press
  208. 'cancel' to continue what ever it was doing before.
  209.  
  210. ___
  211. |?| Will give you information regarding this program.
  212. ---
  213.  
  214. QUIT : WILL QUIT THE PROGRAM (OR PRESS RETURN);
  215.  
  216. DRIVE TYPE: YOU MAY CHOOSE YOUR DRIVE BRAND.
  217.  
  218. SCSI ID EDITABLE FIELD: CHANGE THE SCSI/ACSI ID OF YOUR DEVICE.
  219.  
  220. SAVE CONGIG: It will save the current drive/ID/data file parameters
  221. to a file called AUDIO_CD.INF.
  222.  
  223.  
  224.  
  225.  
  226. If you have any questions/comments/suggestions, send them to:
  227.  
  228. NIMA MONTASER
  229. 204-35 Holland Ave.
  230. Ottawa, ONT.  K1Y 4S2
  231.     CANADA
  232. TEL (613) 798-8280
  233.  
  234. GENIE: S.FARSHIDGH
  235.  
  236.  
  237.  
  238.  
  239. **************************************************************
  240.  
  241.          EXAMPLE OF A DATA FILE.
  242.  
  243. ***************************************************************
  244.  
  245.                        NOTICE:
  246. ****************************************************************
  247.  
  248. If you have already made a *.DAT file for version 1.2, you may use
  249. the same file if you do the following:
  250.  
  251. - Insert a carriage return after the function letter i.e., 'p' so
  252. that the commands would appear on the following line. To understand
  253. this better, please read the following:
  254.  
  255. ******************************************************************* 
  256. RULES:
  257.  
  258. 1- make a file, any file, eg. MITSUMI.DAT with *.DAT for its
  259. extension.
  260.  
  261. 2- Use a text editor (i.e. STENO) to add the following text:
  262.  
  263. to add the play command, add these lines to the file:(don't add
  264. anything in the brackets, they are just my comments!)
  265.  
  266. p
  267. ?? xx xx xx xx xx xx    {make sure there is a carriage return [CR]
  268.                          after the function command, and you start
  269.                          the numbers from the begining of the line} 
  270.                         {- number of xx is equal to number specified in
  271.                          ??
  272.                         - ?? is a number in DECIMAL (not HEX)
  273.                           specifying the SCSI command length)
  274.                         - xx is the the commands in DEC, there should
  275.                           be a total of ??  xx's in the line, WOW!!
  276.                           this tough to explain, but really simple}
  277.  
  278.                         {for example this may be a 'A PLAY COMMAND':
  279.                          p
  280.                          10 75 04 00 00 00 00 00 00 01 00
  281.                                |                          | 
  282.                                 --------------------------
  283.                                              ||
  284.                                   see, there is only commands
  285.                                   specified by the previous number
  286.  
  287.                          notes: the commands only work if they are in
  288.                          DEC format, if they are in hex, just convert
  289.                          them easily by hand or calculator to dec
  290.                          format.  eg. hex=4B ----> dec=75}
  291.  
  292.  
  293. 3- Follow the same format for the rest of the commands starting on
  294. the next line. You can only implement the following:
  295.  
  296. FOR PLAY, enter 'p' in the begining of the line.
  297. FOR STOP, use 's', I suggest you use the following command:
  298.  
  299. s 
  300. 06 01 00 00 00 00 00 
  301.  
  302. For pause, use 'a'
  303.  
  304. For eject, use 'e'
  305. Once you are finished, make sure you add 'q' to the end of the file,
  306. this tells the program that there is no more commands.
  307.  
  308. Track has not been implemented as a function yet.
  309.  
  310.  
  311. SO TO RECAP:
  312.  
  313. - make a file using a text editor with the extension *.dat.
  314. - add the commands in the form explaind above-
  315. - make sure you add 'q' to the end of the file.
  316. - load AUD_CD15.ACC, choose "LOAD *.DAT" from drive selection dialog
  317. box.
  318. - if there is any problems with your file, the program won't run
  319. properly, so make sure everything is alright.
  320. - and you are off to play your favourite compact disc.
  321.  
  322.  
  323.  
  324. IF YOU HAVE ANY COMMENTS/SUGGESTIONS, DON'T HESITATE TO DROP MAIL (E
  325. OR REGULAR) TO :
  326.  
  327. Nima Montaser
  328. 204 -35 Holland Ave.
  329. Ottawa, Ont.  K1Y 4S2
  330.         CANADA
  331.  
  332. Genie: S.FARSHIDGH
  333.  
  334. If you use this program, you are required to pay the shareware fee of
  335. only $ 12.00. You will also receive the full version.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.